This chapter describes the GWCON process and includes the following sections:
The Gateway Console (monitoring) process, GWCON (also referred to as CGWCON), is a second-level process of the device user interface.
Using GWCON commands, you can:
The GWCON command interface is made up of levels called modes. Each mode has its own prompt. For example, the prompt for the SNMP protocol is SNMP>.
If you want to know the process and mode you are communicating with, press enter to display the prompt. Some commands in this chapter, such as the network and protocol commands, allow you to access the various modes in GWCON.
To enter GWCON from OPCON (*), choose one of the following methods:
* console
* status
Then, enter the talk command followed by the PID number for GWCON:
* talk 5
The console displays the GWCON prompt (+). If the prompt does not appear, press enter. Now you can enter GWCON commands.
To return to OPCON, enter the OPCON intercept character. (The default is Ctrl-P.)
This section contains the GWCON commands. Each command includes a description, syntax requirements, and an example. The GWCON commands are summarized in Table 16.
To use the GWCON commands, access the GWCON process by entering talk
5 and enter the GWCON commands at the (+) prompt.
Table 16. GWCON Command Summary
| Command | Function |
|---|---|
| ? (Help) | Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help". |
| Activate | Enables a newly configured spare interface. |
| Boot | Displays information about how the device was booted last. |
| Buffer | Displays information about packet buffers assigned to each interface. |
| Clear | Clears network statistics. |
| Configuration | Lists status of the current protocols and interfaces. |
| Disable | Takes the specified interface off line. |
| Environment | Enters the Environment system console. Displays the current temperature and issues an alert when the temperature threshold, high or low, is passed. |
| Error | Displays error counts. |
| Event | Enters the Event Logging System environment. |
| Fault | Displays information about the last system fault. |
| Feature | Provides access to console commands for independent device features outside the usual protocol and network interface console processes. |
| Interface | Displays network hardware statistics or statistics for the specified interface. |
| Log | Sets or views the logging level for events not included in the Event Logging System. |
| Memory | Displays memory, buffer, and packet data. |
| Network | Enters the console environment of the specified network. |
| Performance | Provides a snapshot of the main processor utilization statistics. |
| Protocol | Enters the command environment of the specified protocol. |
| Queue | Displays buffer statistics for a specified interface. |
| Reset | Disables the specified interface and then re-enables it using new interface, protocol and feature configuration parameters. |
| Statistics | Displays statistics for a specified interface. |
| Test | Enables a disabled interface or tests the specified interface. |
| Uptime | Displays time statistics for the device. |
Use the activate command to enable a spare interface on this device. See "Configuring Spare Interfaces" for more information.
Syntax:
Use the boot command to display boot information for this device.
Syntax:
Example 1:
boot Booted using Ethernet, line 0 at (80740000, 4) as 128.185.227.220 Filename vl.ldc Host 128.185.122.17, Gateway 128.185.227.15
In the first example, the device was booted using TFTP over Ethernet. The message indicates the method of booting, the line number, the CSR (Command and Status Register) address, the IP address, the filename, the host, and the gateway. The line number distinguishes one port from another on a multiport board. The CSR address (the first of the two values in parentheses) identifies which interface board slot was used to boot the device.
The IP address listed after "as" (128.185.227.220 in this example) indicates which IP address the device used as its own IP address. The Filename is the name of the file that has the load image. The IP address listed after Host is the IP address of the server where the file is stored. The Gateway, if listed, is the device that routes the requests and responses between the server and the device that is booting.
Example 2:
boot Manual Booted using Integrated Boot Device Loadname vl.ver1
In the second example, the device was booted manually using the Integrated Boot Device (IBD). Manual indicates that the boot information was entered manually at boot time.
Use the buffer command to display information about packet buffers assigned to each interface or range of interfaces.
| Note: | Each buffer on a device is the same size and is dynamically built. Buffers vary in size from one device to another. |
To display information about one interface only, enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command.
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of network# and range_of_network#). For example, specifying buffer 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
Example:
buffer
Input Buffers: Buffer sizes:
Nt Interface Req Alloc Low Curr Hdr Wrap Data Trail Total Bytes Alloc
0 TKR/0 20 20 7 0 109 92 2052 7 2260 45200
1 PPP/0 20 20 7 20 109 92 2052 7 2260 45200
2 PPP/1 10 10 4 0 108 92 2048 0 2248 22480
Notes:
| Note: | The number of receive buffers allocated is less than the number of receive buffers requested if there is not enough memory available to allocate the requested number of buffers. |
Use the clear command to delete statistical information about one or all of the device's network interfaces. This command is useful when tracking changes in large counters. Using this command does not save space or speed up the device.
Enter the interface (or net) number as part of the command. To get the interface number, use the GWCON configuration command.
Syntax:
To clear information about multiple interfaces, specify the range_of_network# (or a combination of interface# and range_of_interface#). For example, specifying clear 0 3 25-50 clears the information for nets 0, 3, and 25 through 50.
Use the configuration command to display information about the protocols and network interfaces. The output is displayed in three sections, the first section lists the device identification, software version, boot ROM version, and the state of the auto-boot switch. The second and third sections list the protocol and interface information.
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of network# and range_of_network#). For example, specifying configuration 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
Example:
configuration Multiprotocol Routing Services 2210-MRS Feature 3768 V3.2 Mod 0 PTF 0 RPQ 0 MRS.E00 cc4_2a Boot ROM version 1.20 Watchdog timer enabled Auto-boot enabled Time: 15:46:12 Friday September 20, 1996 Console baud rate: 9600 Num Name Protocol 0 IP DOD-IP 3 ARP Address Resolution 11 SNMP Simple Network Management Protocol 12 OSPF Open SPF-Based Routing Protocol 23 ASRT Adaptive Source Routing Transparent Enhanced Bridge 26 DLS Data Link Switching Num Name Feature 2 MCF MAC Filtering 3 Networks: Net Interface MAC/Data-Link Hardware State 0 TKR/0 Token-Ring/802.5 Token-Ring Up 1 Eth/0 Ethernet/IEEE 802.3 Ethernet/802.3 Up 2 PPP/0 Point to Point SCC Serial Line Up
The following information is displayed for protocols:
The following information is displayed for features:
The following information is displayed for networks:
When an interface is operational, the interface periodically sends out maintenance packets and/or checks the physical state of the port or line to ensure that the interface is still functioning correctly. If the maintenance fails, the interface is declared down and a self-test is scheduled to run in 5 seconds. If a self-test fails, the interface transitions to the down state and the interval until the next self-test is increased up to a maximum of 2 minutes. If the self-test is successful, the network is declared up.
When an interface is disabled, it remains disabled until one of the following methods is used to enable it:
WAN Reroute also can change the state of a disabled interface. If an interface is configured as an alternate interface for WAN Reroute and its configured state is disabled, WAN Reroute will start a self-test of the interface when the primary interface goes down. When the primary interface is operational and stable again, WAN Reroute puts the alternate interface back to its configured state. Refer to The WAN Reroute Feature in Using and Configuring Features for more information.
Not Present is also used as the state for a null device. Spare interfaces are displayed as null devices until they are activated.
Use the disable command to take a network interface off-line, making the interface unavailable. This command immediately disables the interface. You are not prompted to confirm, and no verification message displays. If you disable an interface with this command, it remains disabled until you use the GWCON test command or an OPCON restart or reload command to enable it.
Enter the interface or net number as part of the command. To obtain the interface number, use the GWCON configuration command.
| Note: | If the interface you are disabling is configured as an alternate WAN Reroute interface, you are asked if you want to disable any WAN Reroute primary/alternate pairings that include this alternate interface. If you answer yes, the interface is disabled and is no longer available to backup a primary interface. If you answer no, the alternate interface is disabled but WAN Reroute will attempt to bring it up if its corresponding primary interface goes down. See The WAN Reroute Feature, Using WAN Restoral, and Configuring and Monitoring WAN Restoral in the Using and Configuring Features for additional information. |
Syntax:
| Note: | Invoke this command only for routers with two service ports. |
Displays the ENV> prompt, which has three available commands: list, reset-max-min, and exit. Type exit to return to the + prompt.
In extreme temperature conditions, the temperature chip holds the router in a reset state, preventing it from operating. To ensure correct operation of the router due to temperature conditions, the temperature chip allows the router to operate in the range -55°C to 85°C. This is not the operational range.
The temperature chip shuts off the router at 85°C (185°F) or above and does not come back on until it is 80°C (176°F) or below. Only heat affects the chip. It does not cause the router to reset on cold conditions. Minus 55°C (-67°F) is the lowest temperature the chip registers.
Syntax:
The list command displays a status screen with the current temperature, the amount of time between successive temperature readings, the noted maximum and minimum seen since the last reset/clear, and alerts when the temperature threshold, high or low, has been passed, as well as the hysteresis value.
Example:
ENV>list
Time: 14:23:12 Sunday, January 09 2011
Current Ambient Temperature: 44C (111F)
Recalculate temperature approx. every 60 seconds.
Maximum: 48C (118F) at 11:47:32 Friday, January 07 2011
Minimum: 40C (104F) at 15:24:21 Saturday, January 08 2011
Last Max/Min Reset: 09:21:17 Thursday, January 06 2011
High Temperature Alarm Threshold: 85C (185F)
Low Temperature Alarm Threshold: -55C (-67F)
(Hysteresis value: +/- 5C))
The reset-max-min command sets the value of the last recorded maximum and minimum to the current temperature. This is similar to resetting a standard high-low thermometer.
Example
reset-max-min Maximum and Minimum Temperature reset to current ambient temperature: 44C (111F)
Use the error command to display error statistics for the network. This command provides a group of error counters.
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of network# and range_of_network#). For example, specifying error 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
Example:
error
Input Input Input Input Output Output
Nt Interface Discards Errors Unk Proto Flow Drop Discards Errors
0 TKR/0 0 0 0 0 0 0
1 PPP/0 0 0 0 0 0 0
2 PPP/1 0 0 0 0 0 0
| Note: | The sum of the discarded output packets is not the same as input flow drops over all networks. Discarded output may indicate locally originated packets. |
Use the event command to access the Event Logging System (ELS) console environment. This environment is used to set up temporary message filters for troubleshooting purposes. All changes made in the ELS console environment will take effect immediately, but will go away when the device is reinitialized. See "Using the Event Logging System (ELS)" for information about the Event Logging System and its commands. Use the exit command to return to the GWCON process.
Syntax:
Use the fault command to display information about the last system fault. This diagnostic information can help your service representative trace recurring system errors. Output that is generated is for use by the service representative only.
Syntax:
Use the feature command to access console commands for specific 2210 features outside of the protocol and network interface console processes.
Enter a question mark after the feature command to obtain a listing of the features available for your software release.
To access that feature's console prompt, enter the feature command at the GWCON prompt followed by the feature number or short name. Table 7 lists available feature numbers and names.
Once you access the prompt for that feature, you can begin entering specific commands to monitor that feature. To return to the GWCON prompt, enter the exit command at the feature's console prompt.
Syntax:
Use the interface command to display statistical information about the network interfaces (for example, Ethernet). This command can be used without a qualifier to provide a summary of all the interfaces (shown in the following output) or with a qualifier to reveal detailed information about one specific interface.
Descriptions of detailed output for each type of interface are provided in the specific interface Monitoring chapters found in this guide. To obtain the interface number, use the GWCON configuration command.
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of interface# and range_of_interface#). For example, specifying interface 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
Example: interface
Self-Test Self-Test Maintenance Nt Nt' Interface CSR Vec Passed Failed Failed 0 0 Eth/0 81600 5E 1 0 0 1 1 PPP/0 81620 5D 0 31 0 2 2 PPP/1 81640 5C 0 31 0
| Note: | The display varies depending on the device.
|
Use the log command to view or temporarily change the current logging level of messages that are not included in the Event Logging System. The command is temporary and goes away when the device is reinitialized.
To display the current logging level, do not enter an octal number as part of the command. To change the logging level, enter the octal number of the new logging level as part of the command. The default logging level is 76 (octal).
| Note: | To change the initial logging level (that is, the level that the device uses when it starts), use the CONFIG set logging level command. (Refer to "What is CONFIG?" for information about this command.) |
Syntax:
Use the memory command to display the current CPU memory usage in bytes, the number of buffers, and the packet sizes.
To use this command, free memory must be available. The number of free packet buffers may drop to zero, resulting in the loss of some incoming packets; however, this does not adversely affect device operations. The number of free buffers should remain constant when the device is idle. If it does not, contact your service representative.
Syntax:
Example:
memory
Physical installed memory: 16 MB
Total routing (heap) memory: 12 MB
Routing memory in use: 13 %
Total Reserve Never Perm Temp Prev
Alloc Alloc Alloc Alloc
Heap memory 12231155 26488 10687312 1438487 104924 432
Number of global buffers: Total = 300, Free = 300, Fair = 77, Low = 60
Global buff size: Data = 2048, Hdr = 17, Wrap = 72, Trail = 65, Total = 2208
Number of global buffers:
Use the network command to enter the console environment for supported networks, such as X.25 networks. This command obtains the console prompt for the specified interface. From the prompt, you can display statistical information, such as the routing information fields for Token-Ring networks.
Syntax:
At the GWCON prompt (+), enter the configuration command to see the protocols and networks for which the device is configured. See "Configuration" for more information on the configuration command.
Enter interface at the + prompt for a display of the networks for which the device is configured.
Enter the GWCON network command and the number of the interface you want to monitor or change. For example:
+network 3
X.25>
In the example, the X.25> prompt is displayed. You can then view information about the X.25 interface by entering the X.25 operating commands.
After identifying the interface number of the interface you want to monitor, for interface-specific information, see the corresponding monitoring chapter in this manual for the specified network or link-layer interface. Console support is offered for the following network and link-layer interfaces:
Use the performance command at the GWCON prompt to enter the monitoring environment for performance. See "Configuring and Monitoring Performance" for more information.
Use the protocol command to communicate with the device software that implements the network protocols installed in your device. The protocol command accesses a protocol's command environment. After you enter this command, the prompt of the specified protocol appears. From the prompt, you can enter commands that are specific to that protocol.
Syntax:
Enter the protocol number or short name as part of the command. To obtain the protocol number or short name, enter the CONFIG command environment (Config>), and then enter the list configuration command. See "Accessing the Configuration Process, CONFIG (Talk 6)" for instructions on accessing Config>. To return to GWCON, enter exit.
See the corresponding monitoring chapter in this manual or in the Protocol Configuration and Monitoring Reference for information on a specific protocol's console commands.
Use the queue command to display statistics about the length of input and output queues on the specified interfaces. Information about input and output queues provided by the queue command includes:
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of interface# and range_of_interface#). For example, specifying queue 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
To display information about one interface only, enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command.
Example:
queue
Input Queue Output Queue
Nt Interface Alloc Low Curr Fair Curr
0 Eth/0 30 10 30 30 1
1 PPP/0 24 4 24 4 0
2 FR/0 24 4 24 5 0
Input Queue:
Output Queue:
| Note: | When Bandwidth Reservation (BRS) is configured for PPP and Frame Relay interfaces, the output fair value is ignored and the queue lengths configurable with BRS are used to determine if a packet should be discarded due to flow control. |
If a packet is received and the input queue current value is less than the input queue low threshold value, then the packet will be subject to flow control. For locally originated packets, a packet is subject to flow control if the number of free global buffers is less than the low threshold for global buffers. If a packet subject to flow control is to be transmitted on a device which has an output queue current value that is greater than the output queue high threshold (fair), then the packet is dropped instead of queued. When a packet is dropped due to flow control, the output discards counter is incremented and ELS event GW.036 or GW.057 is logged. If the packet was not locally originated, the input flow drop counter for the input interface is incremented. The output discards and input flow drop counters are displayed by the GWCON error command.
Due to the scheduling algorithms of the device, the dynamic numbers of Curr (particularly the Input Queue Curr) may not be fully representative of typical values during packet forwarding. The console code runs only when the input queues have been drained. Thus, Input Queue Curr will generally be nonzero only when those packets are waiting on slow transmit queues.
Use the reset command to disable the specified interface and then re-enable it using new interface, protocol and feature configuration parameters. See "Resetting Interfaces" for more information.
Syntax:
Use the statistics command to display statistical information about the network software, such as the configuration of the networks in the device.
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of interface# and range_of_interface#). For example, specifying statistics 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
To display information about one interface only, enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command.
Example:
statistics
Unicast Multicast Bytes Packets Bytes
Nt Interface Pkts Rcv Pkts Rcv Received Trans Trans
0 Eth/0 137 1 8832 1068 65297
1 PPP/0 0 0 0 0 0
2 PPP/1 0 0 0 0 0
Use the test command to verify the state of an interface or to enable an interface that was previously disabled with the disable command. If the interface is enabled and passing traffic, the test command will remove the interface from the network and run self-diagnostic tests on the interface.
Syntax:
| Note: | For this command to work, you must enter the complete name of the command followed by the interface number. |
Enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command. For example, when testing starts, the console displays the following message:
Testing net 0 TKR/0...
When testing completes or fails, or when GWCON times out (after 30 seconds), the following possible messages are displayed:
Testing net 0 Eth/0 ...successful Testing net 0 Eth/0 ...failed Testing net 0 Eth/0 ...still testing
Some interfaces may take more than 30 seconds before testing is done.
| Note: | If the interface you are testing is configured as an alternate WAN Reroute
interface, you are prompted:
See The WAN Reroute Feature, Using WAN Restoral, and Configuring and Monitoring WAN Restoral in the Using and Configuring Features for additional information. |
Use the uptime command to display time statistics about the device, including the following:
Syntax: